home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wcfile2.zip / WCFILE.DOC next >
Text File  |  1992-02-26  |  43KB  |  870 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   1
  7.           ─────────────────────────────────────────────────────────────────
  8.  
  9.  
  10.      TABLE OF CONTENTS
  11.  
  12.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   2
  13.                HOW TO USE THIS MANUAL . . . . . . . . . . . . . . . . .   2
  14.                WHAT IS WCFILE?  . . . . . . . . . . . . . . . . . . . .   2
  15.                SYSTEM REQUIREMENTS  . . . . . . . . . . . . . . . . . .   2
  16.                TECHNICAL SUPPORT SERVICES . . . . . . . . . . . . . . .   3
  17.                LIMITED WARRANTY . . . . . . . . . . . . . . . . . . . .   4
  18.                DISTRIBUTION POLICY AND COPYRIGHT  . . . . . . . . . . .   4
  19.                     COPYRIGHT . . . . . . . . . . . . . . . . . . . . .   4
  20.                     THE SOURCE CODE . . . . . . . . . . . . . . . . . .   5
  21.  
  22.           INSTALLING WCFILE . . . . . . . . . . . . . . . . . . . . . .   5
  23.  
  24.           COMMAND REFERENCE . . . . . . . . . . . . . . . . . . . . . .   5
  25.                INTERACTIVE OPERATION  . . . . . . . . . . . . . . . . .   5
  26.                     ADDING FILES WITH DESCRIPTION . . . . . . . . . . .   7
  27.                          Move filename and description pointers . . . .   9
  28.                          File group specified after description . . .    10
  29.                          Add to file area . . . . . . . . . . . . . .    10
  30.                          Set "Uploaded by" to . . . . . . . . . . . .    11
  31.                          Add keywords automatically . . . . . . . . .    11
  32.                          Insert extended descriptions . . . . . . . .    11
  33.                          Keep downloads and uploader information  . .    11
  34.                          Add files not on disk as "offline" . . . . .    11
  35.                          Use today's date instead of file date  . . .    11
  36.                          Change descriptions for existing files . . .    12
  37.                     ADDING FILES WITHOUT DESCRIPTIONS . . . . . . . .    12
  38.                          Add to File area . . . . . . . . . . . . . .    13
  39.                          Use today's date . . . . . . . . . . . . . .    13
  40.                          Prompt for description . . . . . . . . . . .    13
  41.                          Add keywords automatically . . . . . . . . .    13
  42.                     SCAN FILES & DIRECTORIES INTO MEMORY  . . . . . .    13
  43.                BATCH OPERATION  . . . . . . . . . . . . . . . . . . .    14
  44.                     COMMAND LINE OPTIONS  . . . . . . . . . . . . . .    14
  45.                          Force Mono . . . . . . . . . . . . . . . . .    14
  46.                          Force Color  . . . . . . . . . . . . . . . .    14
  47.                          Set default uploader . . . . . . . . . . . .    14
  48.                          Set default file area  . . . . . . . . . . .    14
  49.                          Set default positions  . . . . . . . . . . .    14
  50.                          Drive/directory to scan at startup . . . . .    14
  51.                          Add files w/o description  . . . . . . . . .    14
  52.                          Add files w/ description . . . . . . . . . .    14
  53.                          Load table of cross references . . . . . . .    14
  54.                          Set "Offline" flag . . . . . . . . . . . . .    14
  55.  
  56.           ADDING CD-ROMS TO WILDCAT! USING WCFILE . . . . . . . . . .    15
  57.  
  58.           LOGGING AND ERROR MESSAGES  . . . . . . . . . . . . . . . .    15
  59.  
  60.  
  61.  
  62.  
  63.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   2
  64.           ─────────────────────────────────────────────────────────────────
  65.  
  66.  
  67.           INTRODUCTION
  68.  
  69.           HOW TO USE THIS MANUAL
  70.  
  71.           This documentation is organized for use as an initial setup
  72.           guide, and as a reference book. Introductory information on
  73.           WCFILE is presented first, followed by step-by-step installation
  74.           and configuration instructions and command reference.
  75.  
  76.           Since this version of WCFILE has been rewritten completely, it
  77.           introduces many new functions and concepts. We urge you to become
  78.           familiar with the program by printing, reading and saving this
  79.           documentation file. The WCFILE program has context-related online
  80.           help available by pressing [F1] at any point in the program.
  81.           However, there is no substitute for reading the operational
  82.           reference to become familiar with the numerous features
  83.           available. 
  84.  
  85.           After you have installed and run WCFILE, the manual will serve as
  86.           a reference guide. It is indexed extensively. After completing
  87.           the initial setup you should be able to easily locate material on
  88.           any topic by checking the Table of Contents or the Index.
  89.  
  90.           WHAT IS WCFILE?
  91.  
  92.           WCFILE is a utility for adding files and file descriptions to
  93.           your Wildcat database, whether those files exist on your hard
  94.           drive in your regular Wildcat file areas, on CD-ROM in regular
  95.           Wildcat file areas, or in any path or subdirectory on your
  96.           system, whether it's on a CD-ROM, a hard drive, or even off-line.
  97.  
  98.           SYSTEM REQUIREMENTS
  99.  
  100.           WCFILE does not have any special hardware requirements beyond
  101.           what is needed to setup and run WILDCAT! BBS -- its only specific
  102.           requirement is sufficient free disk space to add to your WILDCAT!
  103.           files database, and create its own temporary files during
  104.           operation.
  105.  
  106.           WCFILE 2.2 is designed to operate with WILDCAT! BBS 3.x in the
  107.           Single Line, Multi-Line and Professional versions only. WCFILE
  108.           will NOT work with version 1.x, 2.x, or WILDCAT! TEST DRIVE
  109.  
  110.           Here is the suggested minimum hardware and software
  111.           configuration:
  112.  
  113.           IBM Personal Computer (or true compatible). 
  114.  
  115.           384K (minimum) free RAM.
  116.  
  117.  
  118.  
  119.  
  120.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   3
  121.           ─────────────────────────────────────────────────────────────────
  122.  
  123.  
  124.           Hard disk drive.
  125.  
  126.           80 column monochrome or color monitor.
  127.  
  128.           PC-DOS or MS-DOS, ver 3.0 or later. 
  129.  
  130.           Wildcat! BBS version 3.x 
  131.  
  132.           A CD-ROM drive is optional.
  133.  
  134.           TECHNICAL SUPPORT SERVICES
  135.  
  136.           WCFILE was designed for ease of use, and this manual should
  137.           contain the answers to most of your questions. Read it first and
  138.           check the appendices for trouble-shooting procedures. 
  139.  
  140.           You may first want to call our own WILDCAT! Public-access system
  141.           at 805-395-0650 and leave a quick question to our technical
  142.           staff. You will NOT have full access on your first call since we
  143.           need you to fill out the user database information, such as your
  144.           password, etc. Your security access will be raised as soon as
  145.           possible, usually within 24 -- 48 hours, providing your WILDCAT!
  146.           registration information is on file. This method of obtaining
  147.           support is especially useful if you want expert guidance
  148.           regarding the most advanced features.
  149.  
  150.           Another alternative is CompuServe where we are a part of the PC
  151.           Vendor Support Forum. You reach us by typing GO PCVENA and then
  152.           selecting Sub Topic 9. Our PIN is (75236,3312). 
  153.  
  154.           If you are still unable to find the answer to a question or just
  155.           need a quick explanation, please call us between 9:00am and
  156.           5:00pm Pacific time. You can reach technical support at (805)
  157.           334-2240. 
  158.  
  159.           Support is not available by mail or FAX.
  160.  
  161.           When calling for support please:
  162.  
  163.           -    Have your Wildcat! registration number ready. 
  164.  
  165.           -    Be at your computer with your manual handy. 
  166.  
  167.           -    Be ready to describe the problem in detail.
  168.  
  169.           -    If possible, be ready to duplicate the problem on your
  170.                system.
  171.  
  172.           -    Please be ready to refer to your DOS manual for questions
  173.                regarding DOS. A working knowledge of DOS is absolutely
  174.  
  175.  
  176.  
  177.  
  178.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   4
  179.           ─────────────────────────────────────────────────────────────────
  180.  
  181.  
  182.                necessary.
  183.  
  184.           -    You can call technical support direct at (805) 334-2240.
  185.  
  186.           WCFILE is constantly undergoing enhancements and revisions. This
  187.           is normal software maintenance. The current version of WCFILE may
  188.           be a major or minor release. We can provide the best support to
  189.           users who are running the current major release, and encourage
  190.           you to keep your software updated. The cost is minimal and the
  191.           benefits are great.
  192.  
  193.           LIMITED WARRANTY
  194.  
  195.           THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  196.           THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE PROGRAM
  197.           IS ASSUMED BY YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU (AND
  198.           NOT MUSTANG SOFTWARE, INC. OR ITS DEALERS) ASSUME THE ENTIRE COST
  199.           OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. FURTHER,
  200.           MUSTANG SOFTWARE, INC. DOES NOT WARRANT, GUARANTEE, OR MAKE
  201.           REPRESENTATIONS REGARDING THE USE OF, OR THE RESULTS OF THE USE
  202.           OF THIS PROGRAM IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY,
  203.           CURRENTNESS, OR OTHERWISE; AND YOU RELY ON THE PROGRAM AND ITS
  204.           RESULTS SOLELY AT YOUR OWN RISK. MUSTANG SOFTWARE, INC. CANNOT
  205.           ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF PROFIT, OR ANY
  206.           OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGE RESULTING FROM
  207.           THE USE OR INABILITY TO USE THIS PRODUCT.
  208.  
  209.           Mustang Software, Inc., DOES warrant to the original licensee of
  210.           a REGISTERED product that the program disk(s) on which the
  211.           program is recorded be free from defects in materials and
  212.           workmanship under normal use and service for a period of ninety
  213.           (90) days from the date of delivery as evidenced by a copy of
  214.           your receipt. Mustang Software, Inc.'s entire liability and your
  215.           exclusive remedy shall be replacement of the disk not meeting
  216.           Mustang Software, Inc.'s Limited Warranty.
  217.  
  218.           DISTRIBUTION POLICY AND COPYRIGHT
  219.  
  220.           COPYRIGHT
  221.  
  222.           WCFILE software and this document is (C) Copyright 1992 Mustang
  223.           Software, Inc. All rights reserved. WCFILE is a Trademark of
  224.           Mustang Software, Inc.
  225.  
  226.           Any specific hardware/software names used in this document are
  227.           trademarks of specific manufacturers.
  228.  
  229.           Regardless of the method of marketing, WCFILE is not in the
  230.           public domain. It is copyrighted by Mustang Software, Inc. All
  231.           rights are reserved. We grant you the right to make and
  232.  
  233.  
  234.  
  235.  
  236.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   5
  237.           ─────────────────────────────────────────────────────────────────
  238.  
  239.  
  240.           distribute as many copies of WCFILE as you wish, or post it for
  241.           download from your BBS.
  242.  
  243.           The latest version of WCFILE is always available from the Mustang
  244.           Software HQ! BBS, at 805-395-0650.
  245.  
  246.           THE SOURCE CODE
  247.  
  248.           The source code for WCFILE is not available. This decision gives
  249.           us the ability to guarantee the integrity of our product in this
  250.           era of software contamination. It is not available either under
  251.           the TEST DRIVE concept, or as a Commercial product.
  252.  
  253.      INSTALLING WCFILE
  254.  
  255.           Before you run WCFILE (or any other BBS utility that works
  256.           directly on your datafiles) for the first time, BACK UP. We'll
  257.           say it again. BACK UP your important BBS files.
  258.  
  259.           WCFILE requires no special installation routine. Simply extract
  260.           WCFILE.EXE, WCFILE.HLP and WCFILE.DOC from the distribution file
  261.           and place them in your WILDCAT! home directory. This is normally
  262.           C:\WC30. 
  263.  
  264.      COMMAND REFERENCE
  265.  
  266.           WCFILE should always be run from your WILDCAT! home directory
  267.           (the one that contains MAKEWILD.DAT). It must be run with a
  268.           unique WCNODEID= setting, or you will defeat the file locking
  269.           mechanism and corrupt your WILDCAT! databases. If you are running
  270.           the single line version under DESQview, you MUST bring down
  271.           WILDCAT! before running WCFILE. If you are using the Autonode
  272.           feature on a multiline system, WCFILE will find a free node
  273.           number to use.
  274.  
  275.           INTERACTIVE OPERATION
  276.  
  277.           Here is a brief overview of the way WCFILE functions when used
  278.           interactively:
  279.  
  280.           WILDCAT! BBS has two ways of locating files within each file area
  281.           on your system. The first way is to store files in the drive and
  282.           path specified in the File Area Definition section of MAKEWILD. 
  283.  
  284.           The second way is to store files in other drives and paths
  285.           throughout your system (including files in multiple
  286.           subdirectories on a CD-ROM drive), adding them to a WILDCAT! file
  287.           area by specifying their true path. 
  288.  
  289.           WCFILE supports both options, allowing you to add files anywhere
  290.  
  291.  
  292.  
  293.  
  294.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   6
  295.           ─────────────────────────────────────────────────────────────────
  296.  
  297.  
  298.           on your hard drive, and practically any CD-ROM, to your BBS.
  299.  
  300.           THE MAIN MENU:
  301.  
  302. ┌──────────────────────────────────────────────────────────────────────────────┐
  303. │             WCFILE v2.0  - File database utility for WILDCAT v3              │
  304. └──────────────────────────────────────────────────────────────────────────────┘
  305. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  306. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  307. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  308. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  309. ░░░░░░░░░░░░░░░░░░░╒════════════ WCFILE MENU ═════════════╕░░░░░░░░░░░░░░░░░░░░░
  310. ░░░░░░░░░░░░░░░░░░░│                                      │░░░░░░░░░░░░░░░░░░░░░
  311. ░░░░░░░░░░░░░░░░░░░│ Add files - With Description File    │░░░░░░░░░░░░░░░░░░░░░
  312. ░░░░░░░░░░░░░░░░░░░│ Add files - No description file      │░░░░░░░░░░░░░░░░░░░░░
  313. ░░░░░░░░░░░░░░░░░░░│ Scan Files & Directories into Memory │░░░░░░░░░░░░░░░░░░░░░
  314. ░░░░░░░░░░░░░░░░░░░│ Exit                                 │░░░░░░░░░░░░░░░░░░░░░
  315. ░░░░░░░░░░░░░░░░░░░│                                      │░░░░░░░░░░░░░░░░░░░░░
  316. ░░░░░░░░░░░░░░░░░░░╘══════════════════════════════════════╛░░░░░░░░░░░░░░░░░░░░░
  317. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  318. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  319. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  320. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  321. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  322. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  323. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  324. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  325. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  326.  ESC-Exit  F1-Help
  327.  
  328.           From the main menu you can select the following options:
  329.  
  330.           ■ Add With Description File
  331.  
  332.                This option will add files to your WILDCAT! file database,
  333.                importing descriptions from a prepared description file.
  334.                This may be an ASCII text file on a CD-ROM, an ALLFILES list
  335.                from a BBS, or a capture file from an online session.
  336.  
  337.                The default here is to add files which exist in the drive
  338.                and path pointed to by MAKEWILD's File Area Definition for
  339.                each area. 
  340.  
  341.                You may also add files which exist in other drives and paths
  342.                to a WILDCAT! file area by using the Scan Files &
  343.                Directories Into Memory option first. This procedure stores
  344.                the true path for each file in memory, and adds this
  345.                information to the WILDCAT! file database when you add these
  346.                files. 
  347.  
  348.  
  349.  
  350.  
  351.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   7
  352.           ─────────────────────────────────────────────────────────────────
  353.  
  354.  
  355.           ■ Add Files without Description File
  356.  
  357.                This is a quick way to add files on your disk to your
  358.                Wildcat file database. You have the option to enter
  359.                descriptions manually for each new file. This option only
  360.                adds files which exist in the primary file area path
  361.                specified in Makewild. 
  362.  
  363.           ■ Scan Files & Directories Into Memory
  364.  
  365.                This option scans a drive and/or subdirectory, and stores
  366.                the file names and true paths. Use the Add With Description
  367.                File selection after scanning with this option to add files
  368.                to a WILDCAT file area.
  369.  
  370.                Scanning other drives and paths allows you to add files to a
  371.                file area, even if the files exist outside the file area's
  372.                path as specified in MAKEWILD. This is done by adding the
  373.                file's true path to your WILDCAT! file database. This option
  374.                allows you to add files on CD-ROM drives with unusual
  375.                directory structures.
  376.  
  377.           ■ Exit
  378.  
  379.                Leave the program
  380.  
  381.           ADDING FILES WITH DESCRIPTION
  382.  
  383.           You will first be prompted to enter the drive, path and name of
  384.           the text file you wish to import. If you know the drive, path and
  385.           filename of the description file you wish to import, type the
  386.           information into the window now. You will notice that the window
  387.           will scroll left and right, allowing you to type in a full path. 
  388.  
  389.           Or, you may use the [F2] key to bring up a pick list of files in
  390.           the current drive and subdirectory. Here is a sample screen
  391.           showing the use of a file pick list:
  392.  
  393.  
  394.  
  395.  
  396.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   8
  397.           ─────────────────────────────────────────────────────────────────
  398.  
  399.  
  400. ┌──────────────────────────────────────────────────────────────────────────────┐
  401. │             WCFILE v2.0  - File database utility for WILDCAT v3              │
  402. └──────────────────────────────────────────────────────────────────────────────┘
  403. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  404. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  405. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░╒ F:\PRIVATE\MUSTANG\*╕░░░░░░░░░░░░░░░░░░░░░░░
  406. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ allfiles.lst   251k │░░░░░░░░░░░░░░░░░░░░░░░
  407. ░░░░░░░░░░░░░░░░░░░╒════════════ W│ allfiles.zip    96k │═╕░░░░░░░░░░░░░░░░░░░░░
  408. ░░░░░░░░░░░░░░░░░░░│              │ ansi.key         1k │ │░░░░░░░░░░░░░░░░░░░░░
  409. ░░░░░░░░░░░░░░░░╒═════════════════│ backup.bat       1k │════════╕░░░░░░░░░░░░░░
  410. ░░░░░░░░░░░░░░░░│ Description File│ beta-app.zip     6k │        │░░░░░░░░░░░░░░
  411. ░░░░░░░░░░░░░░░░╘═════════════════│ bsdemo.exe      71k │════════╛░░░░░░░░░░░░░░
  412. ░░░░░░░░░░░░░░░░░░░│ Exit         │ cdfiles.lst     89k │ │░░░░░░░░░░░░░░░░░░░░░
  413. ░░░░░░░░░░░░░░░░░░░│              │ employ.txt       2k │ │░░░░░░░░░░░░░░░░░░░░░
  414. ░░░░░░░░░░░░░░░░░░░╘══════════════│ files.lst        1k │═╛░░░░░░░░░░░░░░░░░░░░░
  415. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ firework.exe     4k │░░░░░░░░░░░░░░░░░░░░░░░
  416. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ fpi_msi.txt      5k │░░░░░░░░░░░░░░░░░░░░░░░
  417. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░╘═══════    for more ═╛░░░░░░░░░░░░░░░░░░░░░░░
  418. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  419. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  420. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  421. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  422. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  423. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  424.  ESC-Exit  F1-Help  F2-Pick Drive
  425.  
  426.           Press [F2] again from this screen to get a pick list of available
  427.           drives. Move the highlight bar to the drive or file you wish to
  428.           select, and press [ENTER].
  429.  
  430.           WCFILE will load the selected text file into a window, and you
  431.           will then see the screen pictured below. We are using
  432.           ALLFILES.LST from the HQ! BBS as an example. On the following
  433.           page is an example of how the description file looks when loaded
  434.           into WCFILE: 
  435.  
  436.  
  437.  
  438.  
  439.           MUSTANG SOFTWARE, INC.                             WCFILE 2.0   9
  440.           ─────────────────────────────────────────────────────────────────
  441.  
  442.  
  443. ┌──────────────────────────────────────────────────────────────────────────────┐
  444. │             WCFILE v2.0  - File database utility for WILDCAT v3              │
  445. └──────────────────────────────────────────────────────────────────────────────┘
  446. ░░╒══════════════════════ Add Files With Descriptions ══════════════════════╕░░░
  447. ░░│**** WC! BBS Advertisements                                              │░░░
  448. ░░│                                                                         │░░░
  449. ░░│AD4BBS.GIF      6,662   02/11/92 | ad for BBS generic                    │░░░
  450. ░░│DwnLds: 28   Last DL:   02/23/92 |                                       │░░░
  451. ░░│                                                                         │░░░
  452. ░░│ADELIGHT.SCR    7,098   12/29/91 | Ad for Afternoon Delight BBS (407)870-│░░░
  453. ░░│DwnLds: 70   Last DL:   02/24/92 |                                       │░░░
  454. ░░│<══ File ══>                     <══════════════ Description ════════════│░░░
  455. ░░│1         12                     34                                      │░░░
  456. ░░│     Move filename & description pointers:   (enter to change)           │░░░
  457. ░░│   File group specified after description: N   Add to File area: 1       │░░░
  458. ░░│                     Set 'uploaded by' to: JOHN DOE                      │░░░
  459. ░░│               Add keywords automatically: Y                             │░░░
  460. ░░│             Insert extended descriptions: N                             │░░░
  461. ░░│  Keep downloads and uploader information: N                             │░░░
  462. ░░│       Add files not on disk as "offline": N                             │░░░
  463. ░░│    Use today's date instead of file date: N                             │░░░
  464. ░░│   Change descriptions for existing files: N                             │░░░
  465. ░░╘═════════════════════════════════════════════════════════════════════════╛░░░
  466. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  467.  ESC-Abort  F1-Help  F2-Pick  F10-Go
  468.  
  469.           WCFILE scans your text file for names and descriptions of files
  470.           to import. A wide range of text file formats are supported -- for
  471.           example, an ALLFILES.LST from a BBS, a capture file from an
  472.           online session, or a description file on a CD-ROM. 
  473.  
  474.           Here is a step-by-step discussion of the options available in
  475.           this screen:
  476.  
  477.           Move filename and description pointers: (enter to change)
  478.  
  479.                For WCFILE to use your text file to import descriptions, you
  480.                need to tell it where the file name and description fields
  481.                begin and end. The arrows at the bottom of the file
  482.                description should point to the start and end of the file
  483.                name and description fields within the description file.  
  484.  
  485.                To line up the pointers with the beginning and ending of the
  486.                name and description fields, press the TAB key to highlight
  487.                an arrow, then move the arrow left or right using the LEFT
  488.                and RIGHT cursor keys. You cannot make the file name field
  489.                shorter than 12 characters, or the description field shorter
  490.                than 20 characters. 
  491.  
  492.                When you have positioned the arrows correctly, press F10 to
  493.  
  494.  
  495.  
  496.  
  497.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   10
  498.           ─────────────────────────────────────────────────────────────────
  499.  
  500.  
  501.                continue. 
  502.  
  503.           File group specified after description:
  504.  
  505.                Some CD-ROMS (for example RBBS in a Box) contain file path
  506.                information at the end of the file description field,
  507.                showing the file's true location on the disk. By answering
  508.                "Yes" to this option, WCFILE will read the path information
  509.                and store it in the file database. 
  510.  
  511.           Add to file area:
  512.  
  513.                You may add files to one WILDCAT! file area at a time.
  514.                Please select the file area you would like to update. By
  515.                default, only files which exist in the path specified in the
  516.                file area definition for each area will be added. If you
  517.                Scan files & directories into memory first, files in other
  518.                paths will be added to the database. Press F2 to pop up a
  519.                pick list of available WILDCAT! file areas. 
  520.  
  521.                Below is a screen snapshot of a file area pick list:
  522.              
  523. ┌──────────────────────────────────────────────────────────────────────────────┐
  524. │             WCFILE v2.0  - File database utility for WILDCAT v3              │
  525. └──────────────────────────────────────────────────────────────────────────────┘
  526. ░░╒══════════════════════ Add Files With Descriptions ══════════════════════╕░░░
  527. ░░│**** WC! BBS Advertisements                                              │░░░
  528. ░░│                                    ╒════════════ File Area ════════════╕│░░░
  529. ░░│AD4BBS.GIF      6,662   02/11/92 | a│   1 - Utilities                   ││░░░
  530. ░░│DwnLds: 28   Last DL:   02/23/92 |  │   2 - Games                       ││░░░
  531. ░░│                                    │   3 - CAD Support Files           ││░░░
  532. ░░│ADELIGHT.SCR    7,098   12/29/91 | A│   4 - Word Perfect Utilities      ││░░░
  533. ░░│DwnLds: 70   Last DL:   02/24/92 |  │   5 - Text Information            ││░░░
  534. ░░│<══ File ══>                     <══│   6 - UPLOADS (private until rev'd││░░░
  535. ░░│1         12                     34 │   7 -                             ││░░░
  536. ░░│     Move filename & description poi│   8 -                             ││░░░
  537. ░░│   File group specified after descri│   9 -                             ││░░░
  538. ░░│                     Set 'uploaded b│  10 -                             ││░░░
  539. ░░│               Add keywords automati│  11 -                             ││░░░
  540. ░░│             Insert extended descrip│  12 -                             ││░░░
  541. ░░│  Keep downloads and uploader inform│  13 -                             ││░░░
  542. ░░│       Add files not on disk as "off╘═════════════════════    for more ═╛│░░░
  543. ░░│    Use today's date instead of file date: N                             │░░░
  544. ░░│   Change descriptions for existing files: N                             │░░░
  545. ░░╘═════════════════════════════════════════════════════════════════════════╛░░░
  546. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  547.  ESC-Abort  F1-Help  F2-Pick  F10-Go
  548.  
  549.  
  550.  
  551.  
  552.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   11
  553.           ─────────────────────────────────────────────────────────────────
  554.  
  555.  
  556.           Set "Uploaded by" to:
  557.  
  558.                This is the name which will appear in the "Uploaded by:"
  559.                field in the WILDCAT! file database. The default is the name
  560.                of the sysop, as entered in MAKEWILD.
  561.  
  562.           Add keywords automatically:
  563.  
  564.                Select "Yes" for this option if you want WCFILE to generate
  565.                keywords automatically from the file description, answer
  566.                "No" to leave the keywords blank. 
  567.  
  568.           Insert extended descriptions:
  569.  
  570.                If you answer "Yes" to this option, WCFILE will import
  571.                multi-line file descriptions into the "Extended Description"
  572.                field in your WILDCAT! file database for each entry. Be
  573.                aware that this will take additional space in your file
  574.                database.
  575.  
  576.           Keep downloads and uploader information: 
  577.  
  578.                If you answer "Yes" to this option, WCFILE will preserve the
  579.                name of the uploader and the number of downloads for each
  580.                file.
  581.  
  582.                WILDCAT! two-line file descriptions containing this
  583.                information are supported directly. Other text file listings
  584.                should contain the information in the following format(s):
  585.  
  586.                ■ The text "UPLOADED BY:" should be at the beginning of a
  587.                description line.
  588.  
  589.                ■ The number of downloads should be specified by "<nnn>" or
  590.                "[nnn]" at the beginning of a description line.
  591.  
  592.           Add files not on disk as "offline":
  593.  
  594.                This option allows you to add "Offline" files to your
  595.                WILDCAT! database, by importing a list of filenames and
  596.                descriptions for files which do not actually exist on your
  597.                disk. WCFILE will set the "Offline" flag in each database
  598.                record, and WILDCAT! will prompt your users to generate a
  599.                request to the sysop if they wish to download these offline
  600.                files.
  601.  
  602.           Use today's date instead of file date:
  603.  
  604.                If you wish the files you add to your database to show up as
  605.                "New files" regardless of the actual file date, WCFILE will
  606.  
  607.  
  608.  
  609.  
  610.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   12
  611.           ─────────────────────────────────────────────────────────────────
  612.  
  613.  
  614.                add them to the database using today's date.
  615.  
  616.           Change descriptions for existing files:
  617.  
  618.                If this option is set to "Y", WCFILE will use the file
  619.                descriptions in the text file to overwrite the descriptions
  620.                in your WILDCAT! file database. This option is useful for
  621.                adding descriptions to files currently in the database, but
  622.                lacking descriptions, or to import a spell-checked, edited
  623.                text listing of your file database to replace incorrect
  624.                entries. 
  625.  
  626.           ADDING FILES WITHOUT DESCRIPTIONS
  627.  
  628.           You may add files to one WILDCAT! file area at a time. Please
  629.           select the file area you would like to update. By default, only
  630.           files which exist in the path specified in the file area
  631.           definition for each area will be added. If you use the Scan files
  632.           & directories into memory first, files in other paths will be
  633.           added to the database.
  634.  
  635.           You will see the following menu:
  636.  
  637. ┌──────────────────────────────────────────────────────────────────────────────┐
  638. │             WCFILE v2.0  - File database utility for WILDCAT v3              │
  639. └──────────────────────────────────────────────────────────────────────────────┘
  640. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  641. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  642. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  643. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  644. ░░░░░░░░░░░░░░░░░░░╒════════════ WCFILE MENU ═════════════╕░░░░░░░░░░░░░░░░░░░░░
  645. ░░░░░░░░░░░░░░░░░░░│                                      │░░░░░░░░░░░░░░░░░░░░░
  646. ░░░░░░░░░░░░░░░░░░░│ Add files - With Description File    │░░░░░░░░░░░░░░░░░░░░░
  647. ░░░░░░░░░╒═══════════ Add Files Without Descriptions ════════════╕░░░░░░░░░░░░░░
  648. ░░░░░░░░░│                                                       │░░░░░░░░░░░░░░
  649. ░░░░░░░░░│            Add to file area: 1                        │░░░░░░░░░░░░░░
  650. ░░░░░░░░░│             Set uploader to: JOHN DOE                 │░░░░░░░░░░░░░░
  651. ░░░░░░░░░│           Use today's date:  N                        │░░░░░░░░░░░░░░
  652. ░░░░░░░░░│      Prompt for description: Y                        │░░░░░░░░░░░░░░
  653. ░░░░░░░░░│  Add keywords automatically: Y                        │░░░░░░░░░░░░░░
  654. ░░░░░░░░░│                                                       │░░░░░░░░░░░░░░
  655. ░░░░░░░░░╘═══════════════════════════════════════════════════════╛░░░░░░░░░░░░░░
  656. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  657. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  658. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  659. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  660. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  661.  ESC-Abort  F1-Help  F2-Pick  F10-Go
  662.  
  663.  
  664.  
  665.  
  666.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   13
  667.           ─────────────────────────────────────────────────────────────────
  668.  
  669.  
  670.           Add to File area: 
  671.  
  672.                Again, you may add files to one WILDCAT! file area at a
  673.                time. Press [F2] for a pick list of available file areas.
  674.  
  675.           Set uploader to:
  676.  
  677.                This is the name which will appear in the "Uploaded by:"
  678.                field in the WILDCAT! file database. The default is the name
  679.                of the sysop, as entered in MAKEWILD.
  680.  
  681.           Use today's date:
  682.  
  683.                If you wish the files you add to your database to show up as
  684.                "New files" regardless of the actual file date, WCFILE will
  685.                add them to the database using today's date.
  686.  
  687.           Prompt for description:
  688.  
  689.                Answer "Yes" if you would like WCFILE to prompt you to type
  690.                in a file description for each file added to the database.
  691.  
  692.           Add keywords automatically:
  693.  
  694.                Answer "Yes" if you would like WCFILE generate keywords
  695.                automatically when you type in the file description. This
  696.                option may be selected only if you answer "Yes" to the
  697.                "Prompt for description" option.
  698.  
  699.           SCAN FILES & DIRECTORIES INTO MEMORY
  700.  
  701.           This option scans a drive and/or subdirectory, and stores the
  702.           file names and true paths in a temporary file. Use the Add With
  703.           Description File selection after scanning with this option to add
  704.           files to a WILDCAT file area.
  705.  
  706.           Scanning other drives and paths allows you to add files to a file
  707.           area, even if the files exist outside the file area's path as
  708.           specified in MAKEWILD. This is done by adding the file's true
  709.           path to your WILDCAT! file database. This option allows you to
  710.           add files on CD-ROM drives with unusual directory structures. 
  711.  
  712.           This also allows you to add files to more than one WILDCAT! file
  713.           area, when using the "Add files with descriptions" option. WCFILE
  714.           will add ALL files it finds in valid WILDCAT file areas to the
  715.           correct area if the disk is scanned prior to adding files with
  716.           description.
  717.  
  718.           To use this option prior to adding files, enter the drive letter,
  719.           or subdirectories within a drive, that you wish WCFILE to scan.
  720.  
  721.  
  722.  
  723.  
  724.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   14
  725.           ─────────────────────────────────────────────────────────────────
  726.  
  727.  
  728.           BATCH OPERATION
  729.  
  730.           WCFILE can be run with the following command line switches, for
  731.           use as a batch processing event.
  732.  
  733.           COMMAND LINE OPTIONS
  734.  
  735.                /M                  Force Mono
  736.  
  737.                /C                  Force Color
  738.  
  739.                /U:<uploader>       Set default uploader
  740.  
  741.                /A:<area>           Set default file area
  742.  
  743.                /P:fs,fe,ds,de      Set default positions of start and end
  744.                                    of filename and description for add
  745.                                    w/description (if they're not valid the
  746.                                    defaults of 1,12,34,76 are used). The
  747.                                    length of the description must be at
  748.                                    least 20, the filename at least 12 
  749.  
  750.                /S:<scanarea>       Drive/directory to scan at startup
  751.  
  752.                /D                  Add files w/o description - NON
  753.                                    INTERACTIVE
  754.  
  755.                /D:<descrfile>      Add files w/ description - NON
  756.                                    INTERACTIVE
  757.  
  758.                /X:<xreffile>       Load table of cross references for add
  759.                                    with area specified at end of
  760.                                    description. File should be in the
  761.                                    format:
  762.  
  763.                                    <Listed File Area>,<Wildcat File Area>
  764.                                    <Listed File Area>,<Wildcat File Area>
  765.                                    <Listed File Area>,<Wildcat File Area>
  766.                                    <Listed File Area>,<Wildcat File Area>
  767.  
  768.                                    If this is not specified you will be
  769.                                    prompted for each new file area.
  770.  
  771.                /O                  Set "Offline" flag for files not found
  772.                                    on disk 
  773.  
  774.  
  775.  
  776.  
  777.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   15
  778.           ─────────────────────────────────────────────────────────────────
  779.  
  780.  
  781.      ADDING CD-ROMS TO WILDCAT! USING WCFILE
  782.  
  783.           Since each CD-ROM is arranged in a slightly different way, and
  784.           updates are frequent and unpredictable, WCFILE takes a "generic"
  785.           approach to adding these ROMs to your WILDCAT! database.
  786.  
  787.           Your first task, when installing a CD-ROM to use with WILDCAT!,
  788.           is to take a look at its structure. 
  789.  
  790.           The easiest to install are those with lots of files organized
  791.           into a group of directories by topic. A good example of this
  792.           would be the CARRS disk. Each subdirectory contains a text file
  793.           listing the contents of that directory, with file names, dates,
  794.           sizes, and descriptions. 
  795.  
  796.           All you need to do to install CD-ROMS organized this way, is to
  797.           make a note of the paths on the CD-ROM, then run MAKEWILD and add
  798.           each of these paths as a file area. Then run WCFILE, scan the
  799.           entire disk, then select "Add files with descriptions". Type in
  800.           the name and path of the description file(s), and let WCFILE
  801.           process it.
  802.  
  803.           Other CD-ROM disks are organized differently, with files in
  804.           multiple subdirectories but belonging to the same file area.
  805.           These require you to create a WILDCAT! file area that points to a
  806.           subdirectory on your hard drive. Scan the disk using the "Scan
  807.           Files & Directories into Memory", then use the "Add files with
  808.           descriptions" option, as above.
  809.  
  810.           WCFILE will enter these files in your WILDCAT! file area, and
  811.           place the true location of the file in the "Path on CD-ROM" field
  812.           in the file database. It will create zero-byte files for each
  813.           file name on your hard disk in the primary file path you
  814.           specified for WILDCAT! for this file area. The zero-byte files
  815.           help speed up wildcard searches by reading a DOS directory rather
  816.           than the file database for this function.
  817.  
  818.           A third type of CD-ROM, typified by "RBBS in a Box" organizes
  819.           files in multiple subdirectories, but includes the file area at
  820.           the end of the file description line in the "DIR" file. If this
  821.           information is present in the file, first scan the disk, then use
  822.           the "Add files with descriptions" to add the files. Toggle the
  823.           "File area specified at end of description" to "Yes", and let
  824.           WCFILE add the files.
  825.  
  826.      LOGGING AND ERROR MESSAGES
  827.  
  828.           WCFILE logs its activity in WCFILE.LOG, and reports the name of
  829.           each file added to the database. When adding files with
  830.           descriptions, any text in a description file which WCFILE is
  831.  
  832.  
  833.  
  834.  
  835.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   16
  836.           ─────────────────────────────────────────────────────────────────
  837.  
  838.  
  839.           unable to parse will be logged for your examination.
  840.  
  841.           Fatal errors cause WCFILE to exit to DOS, display a descriptive
  842.           error message in bright white flashing letters on screen, and
  843.           write the error message to the WCFILE.ERR log in the \WC30
  844.           directory before returning control to Wildcat. These messages are
  845.           usually self-explanatory. 
  846.  
  847.           Complete lockups are rare, and usually indicate a hardware
  848.           problem, or a TSR or other program interfering with WCFILE. Two
  849.           kinds of programs known to cause problems with WCFILE and
  850.           WILDCAT! are TSR file compressor-decompressor programs -- those
  851.           which claim to increase hard disk space; and the resident MIRROR
  852.           program with DOS 5. 
  853.  
  854.           A few error messages may be the result of a corrupted Wildcat
  855.           database -- these are usually caused by running WCFILE and the
  856.           single line version of Wildcat in two DESQview windows at the
  857.           same time, or by duplicating node ID numbers in the multi-line
  858.           versions of Wildcat. Certain third party utilities which do not
  859.           lock and unlock files properly may cause share violations or
  860.           locking problems if run concurrently with WCFILE. 
  861.  
  862.  
  863.  
  864.  
  865.           MUSTANG SOFTWARE, INC.                            WCFILE 2.0   17
  866.           ─────────────────────────────────────────────────────────────────
  867.  
  868.  
  869.            
  870.